home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1993 July / InfoMagic USENET CD-ROM July 1993.ISO / sources / unix / volume4 / msg / fmtd1 next >
Encoding:
Text File  |  1986-11-30  |  25.6 KB  |  1,102 lines
  1. Newsgroups: mod.sources
  2. From: decvax!genrad!panda!sources (John P. Nelson)
  3. Subject: Msg docs preformatted (part 1 of 2)
  4. Approved: jpn@panda.UUCP
  5.  
  6. Mod.sources:  Volume 4, Issue 35
  7.  
  8. If your site has the "mm" macro package, then you don't need this, the
  9. formatted documentation for the Msg mail system.
  10.  
  11. #! /bin/sh
  12. # This is a shell archive, meaning:
  13. # 1. Remove everything above the #! /bin/sh line.
  14. # 2. Save the resulting text in a file.
  15. # 3. Execute the file with /bin/sh (not csh) to create the files:
  16. #    Alias.fmtd
  17. #    Config.fmtd
  18. # This archive created: Sat Mar 15 10:06:15 1986
  19. export PATH; PATH=/bin:$PATH
  20. echo shar: extracting "'Alias.fmtd'" '(13394 characters)'
  21. if test -f 'Alias.fmtd'
  22. then
  23.     echo shar: will not over-write existing file "'Alias.fmtd'"
  24. else
  25. cat << \SHAR_EOF > 'Alias.fmtd'
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                    A Users Guide to the
  34.                       MSG Alias System
  35.  
  36.                    (C) Copyright 1986, by
  37.                         Dave Taylor
  38.  
  39.                        March 15, 1986
  40.  
  41.  
  42.      This document is intended as a supplement  to  the  Msg
  43. Users  Guide and is only of interest to those users desiring
  44. more knowledge about how aliases  work  and  how  to  create
  45. strange  and exciting aliases for their systems (alright, so
  46. it's not that exciting!)
  47.  
  48.  
  49.      This document is broken up into the following sections;
  50. user  aliases,  group  aliases,  system aliases, editing and
  51. installing new aliases, the machine  routing  database,  and
  52. general warnings and other chitchat.
  53.  
  54.  
  55.  
  56. 1.  User Aliases
  57.  
  58.      The most simple sort of aliases in the Msg  system  are
  59. individual user aliases.  These are made up of three parts;
  60.  
  61.         <aliasname list> : <username> : <address>
  62.  
  63. Where the alias list is either a single aliasname* or a list
  64. of aliasnames separated by commas.
  65.  
  66.      Username is currently a comment field, and is  used  to
  67. indicate  the  full  "real name" that the alias is for.  For
  68. example, if you had an alias for "dat" to  get  to  me,  the
  69. username  field would contain "Dave Taylor" or perhaps "Dave
  70. Taylor, HP" or some other permutation of that.  In a  future
  71. release of the mailer, the alias system will know about this
  72. field and include it in outgoing messages AND as  a  supple-
  73. ment to the usual list of aliasnames.
  74.  
  75.      Address  is  either  the  users  full  electronic  mail
  76. address  or,  if  the machine routing database is installed,
  77.  
  78.  
  79. __________
  80.  
  81.   * Please see the appendix for a full definition of what
  82.     exactly an aliasname consists of.
  83.  
  84.  
  85.  
  86.  
  87. Page 1
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99. the minimum address needed to specify the destination.   For
  100. example,  say  our routing database contained information on
  101. how to get to machine "hp-sdd"  and  I  wanted  to  have  an
  102. address  for  my friend Ken there - I could have his address
  103. specified as  simply  "ken@hp-sdd"  (or  alternatively  "hp-
  104. sdd!ken" since the two are functionally equivalent).
  105.  
  106.  
  107. Let's get on to some examples, shall we?
  108.  
  109. Consider this excerpt from my own .alias_text file;
  110.  
  111.  wunder,walt   : Walt Underwood  : wunder@hpcea
  112.  laubach       : Mark Laubach    : laubach@hpcea
  113.  mary          : Mary Hsia-Coron : hsia@hpindla
  114.  decot         : Dave Decot      : decot@hpda
  115.  
  116.  jeff          : Jeff Wu         : hpcnoe!j_wu
  117.  dave          : Dave Barrett    : hpcnof!d_barrett
  118.  
  119. Note that the alias for Walt Underwood  has  two  aliasnames
  120. associated  with  it, "wunder" and "walt".  Also notice that
  121. the first four aliases use the ARPA style naming  convention
  122. (user@machine)  but  the last two use the UUCP style conven-
  123. tion (machine!user).  In this context it is independent.
  124.  
  125.      The only time when it  does  make  a  difference  which
  126. notation  you  use  is  if you have to specify more than the
  127. machine that the user is receiving mail on.  That is, say we
  128. have  a  friend  who  receives  mail  at  a  machine  called
  129. "twinkie"  and  our  best  connection  is  through   Georgia
  130. Tech...Then our alias for them could be;
  131.  
  132.   buddy         : Our friend      : gatech!twinkie!buddy
  133.  
  134. or
  135.  
  136.   buddy2        : Our friend      : gatech!buddy@twinkie
  137.  
  138. but not;
  139.  
  140.   buddy         : Our friend      : buddy@twinkie@gatech
  141.  
  142. (however, buddy%twinkie@gatech will also  work,  but  that's
  143. far  too  bizarre  a  notation to be recommended!!) (besides
  144. there's no guarantee that "gatech" will  like  it,  nor  the
  145. "buddy2" alias above!)
  146.  
  147.      Anyway, suffice to say that if  you  must  specify  any
  148. sort  of route that you should use the uucp notation as much
  149. as possible to  ensure  that  the  Msg  system  expands  the
  150.  
  151.  
  152.  
  153. Page 2
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165. correct machine name.
  166.  
  167.  
  168.  
  169. 2.  Group Aliases
  170.  
  171.      After the confusion of user aliases, group aliases  are
  172. even more fun!  For the most part the notation is very simi-
  173. lar;
  174.  
  175.         <aliasname list> : <groupname> : <list of people>
  176.  
  177. Where aliasname list and groupname are exactly equivalent to
  178. the corresponding fields in user aliases.
  179.  
  180.      The interesting part is the list of people field!  This
  181. field  is  actually  in  the  same notation as the aliasname
  182. list, so it's not quite as  strange  as  I've  lead  you  to
  183. believe.  It's best to illustrate by example;
  184.  
  185. friends, mypals, gang : The Gang of Six : joe, larry, mary, joanna,
  186.                                           nancy, michael
  187.  
  188. (Notice that you can continue onto as many  lines  as  you'd
  189. like  so  long  as  each additional line start with either a
  190. SPACE or a TAB character)
  191.  
  192.      The significant limitation with group aliases  is  that
  193. each  of the people in the list must be a previously defined
  194. aliasname in either the existing alias file  or  the  system
  195. alias file or a valid destination on the current machine.
  196.  
  197.      What does this mean?  This  means  that  the  following
  198. excerpt from an alias file;
  199.  
  200. hawaii : The Hawaiian Twins : joe@RIT-CS.ARPA, maoa
  201. maoa   : Maoa Lichtenski Jr : maoa@Hawaii.cs.uh.ARPA
  202.  
  203. will fail for two reasons - not only does the group list  of
  204. people  contain  a  complex address, but it also contains an
  205. aliasname that is defined later in the .alias_text file!  **
  206. BEWARE!!! **
  207.  
  208.      The correct way to have the previous alias in the  file
  209. is to have it like;
  210.  
  211. joe    : Joe Lichtenski     : joe@RIT-CS
  212. maoa   : Maoa Lichtenski Jr : maoa@Hawaii
  213. hawaii : The Hawaiian Twins : joe, maoa
  214.  
  215. which will then work correctly.
  216.  
  217.  
  218.  
  219. Page 3
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231. This isn't too hard now, is it?
  232.  
  233. Fortunately, while this seems pretty tough, if you  run  the
  234. newalias  command  to install your new aliases, it will give
  235. you nice meaningful error messages that will  help  you  fix
  236. the list up correctly!
  237.  
  238.  
  239.  
  240. 3.  System Aliases
  241.  
  242.      System aliases are functionally equivalent to the indi-
  243. vidual  Msg alias lists each Msg user has (both user aliases
  244. and group aliases) but are "read only" for everyone but  the
  245. Msg  administrator.   The format of the file is identical to
  246. the users file, and the only difference is that this file is
  247. expected  to  be  located in the directory that contains the
  248. "system_hash_file" and "system_data_file" files (see the Msg
  249. Configuration Guide for more details on these variables).
  250.  
  251.      Simply create a .alias_text file in the specific direc-
  252. tory as you would a normal file, and install it the same way
  253. (see the following section for more details on that).
  254.  
  255.      Voila!!
  256.  
  257.  
  258.  
  259. 4.  Editing and Installing New Aliases
  260.  
  261.      To install new aliases, you need merely to  create,  or
  262. modify,  your  .alias_text file in your home directory until
  263. you're satisfied with  it  and  it  meets  the  requirements
  264. stated  above.  You can then try to install it with the com-
  265. mand;
  266.  
  267.         $ newalias
  268.  
  269. which  will  either  report  back  the  number  of   aliases
  270. installed  into  the system or will report errors indicative
  271. of the changes that the program expects before it can accept
  272. the alias list.
  273.  
  274.      Note that blank lines are no problem and that  comments
  275. are  not only allowed but actually encouraged, and must have
  276. # as the first character of each comment line.
  277.  
  278. Finally, if you find  that  you're  hitting  the  "Too  many
  279. aliases"  error,  then you'll need to reconfigure the entire
  280. Msg system (again, see the  Msg  Configuration  Guide  espe-
  281. cially  the  discussion on "MAX_UALIASES" and "MAX_SALIASES"
  282.  
  283.  
  284.  
  285. Page 4
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297. therein).
  298.  
  299.  
  300.  
  301. 5.  The Hostname Routing Database
  302.  
  303.      Floating about on the  various  networks  is  a  rather
  304. nifty  program by a number of people, including Peter Honey-
  305. man and  Steve  Bellovin,  called  "pathalias".   What  this
  306. incredibly  handy  program does is take the strange postings
  307. in groups like "mod.map" and massage them into a file of the
  308. form;
  309.  
  310.   <hostname>    <address>
  311.  
  312. which is then sorted alphabetically and stored in  the  file
  313. pointed  to  by  "pathfile"  (guess  where  to look for more
  314. information!) for Msg to use.
  315.  
  316.      If you don't have the program, or don't want to use it,
  317. you  can  simulate this file by listing machines in the same
  318. format.  The exact format expected is;
  319.  
  320.   <hostname><tab><machine-address>
  321.  
  322. where hostname is a limited identifier (no  special  charac-
  323. ters)  and  machine-address  MUST  contain the sequence "%s"
  324. (and consequently any other percent signs that appear in the
  325. address  must  be  paired)  so  that the call in the program
  326. "sprintf(buffer, machine-address, username)" will generate a
  327. valid return address.
  328.  
  329. By way of example, here are a few entries from my own file;
  330.  
  331.  HPL        hplabs!%s
  332.  PARC       hplabs!%s@Xerox.PA.COM
  333.  amc-hq     hplabs!%s@AMC-HQ.ARPA
  334.  imsss      hplabs!%s%%IMSSS@SU-AI.ARPA
  335.  infopro    hpfcla!ihnp4!astrovax!infopro!%s
  336.  interleaf  hpfcdc!hpda!sun!interleaf!%s
  337.  jpl-vax    hplabs!%s@jpl-vax
  338.  
  339. As you can see, the addresses can get  pretty  complicated!!
  340. In  fact it's due purely to the complication that a database
  341. file of this sort can be so wonderful!!
  342.  
  343. If you'd like further information on the pathalias  program,
  344. try  keeping  track  of  the entries in "mod.sources" - it's
  345. posted about once a year or so...
  346.  
  347.  
  348.  
  349.  
  350.  
  351. Page 5
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363. 6.  Other Stuff not Covered Yet
  364.  
  365.      Probably the biggest question you  have  in  your  mind
  366. right  now is "But how the heck does this relate to the 'ole
  367. mailx aliases and the snazzo sendmail alias system??"  Well,
  368. rest assured, sendmail fans, that if you REALLY want to have
  369. your aliases down in the transport  you  can.   No  problem.
  370. All  you'll need to do is to turn off the address validation
  371. routine in Msg by defining the  "NOCHECK_VALIDNAME"  defini-
  372. tion (I'm not even going to bother to tell you where to look
  373. for this one!!).
  374.  
  375.      For those mailx fanatics out there, you  can  translate
  376. your  aliases into the format that Msg wants by running them
  377. through the awk script listed in Appendix Two.
  378.  
  379.  
  380.      Finally, if you have any  problems  or  questions,  try
  381. looking  in the newalias manual entry, or dropping me a line
  382. at the "usual" email address (ask your administrator!).
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417. Page 6
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.                         Appendix One
  430.  
  431.               A BNF of the Alias File Grammar
  432.  
  433.  
  434. In this listing, items in  <>  brackets  are  non-terminals,
  435. items  in {} are optional, and items in bold face are termi-
  436. nals.
  437.  
  438.  
  439.  
  440. <alias_file>  ::=  <line> { <alias_file> }
  441.  
  442. <line>        ::=  <comment> | <empty> | <alias>
  443.  
  444. <comment>     ::=  .. any sequence of characters starting with '#' ..
  445.  
  446. <empty>       ::=  .. an empty line ..
  447.  
  448. <alias>       ::=  <user alias> | <group alias>
  449.  
  450. <user alias>  ::=  <aliaslist> : { <comment> : }
  451.                    {<whitespace>} <address>
  452.  
  453. <group alias> ::=  <aliaslist> : { <comment> : }
  454.                    {<whitespace>} <list of addresses>
  455.  
  456. <aliaslist>   ::=  <aliasname> { , <aliaslist> }
  457.  
  458. <aliasname>   ::=  <alpha-char> { <sequence-of-chars> }
  459.  
  460. <comment>     ::=  .. anything other than ":" ..
  461.  
  462. <address>     ::=  <username> | <arpa-address> | <uucp-address> |
  463.                    <complex-address>
  464.  
  465. <list-of-addresses> ::= <aliasname> { , <whitespace> }
  466.                         { <list-of-addresses> }
  467.  
  468. <username>    ::=  .. any valid mailbox name on the system ..
  469.  
  470. <arpa-address> ::= <username> ( @ <hostname> | <postfix> )
  471.  
  472. <hostname>    ::=  .. any legal host machine name ..
  473.  
  474. <uucp-address> ::= <hostname> ! <username>
  475.  
  476. <complex-address> ::= <prefix> ( <uucp-address> | <arpa-address> )
  477.  
  478. <prefix>      ::= <hostname> ! { <prefix> }
  479.  
  480.  
  481.  
  482.  
  483. Page 7
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495. <postfix>     ::= % <hostname> { <postfix> } @
  496.                   <hostname>
  497.  
  498. <sequence-of-chars> ::= .. any characters other than space, tab,
  499.                            return, or colon ..
  500.  
  501. <whitespace> ::= .. space, tab or newline followed by space or tab ..
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549. Page 8
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.                         Appendix Two
  562.  
  563.                      An AWK Script for
  564.                  Translating Aliases from a
  565.                    ".mailrc" Format to a
  566.                          Msg Format
  567.  
  568.  
  569. -------------------------------------------------------------------
  570.  
  571. BEGIN {
  572.         print "# MSG alias_text file, from a .mailrc file..."
  573.         print ""
  574.       }
  575.  
  576. next_line == 1 {
  577.  
  578.         next_line = 0;
  579.         group = ""
  580.         for (i = 1; i <= NF; i++) {
  581.           if (i == NF && $i == "\\") sep = ""
  582.           else                       sep = ", "
  583.  
  584.           if ($i == "\\") {
  585.             group = sprintf("%s,", group)
  586.             next_line = 1;
  587.           }
  588.           else if (length(group) > 0)
  589.             group = sprintf("%s%s%s", group, sep, $i);
  590.           else
  591.             group = $i;
  592.           }
  593.           print "\t" group
  594.  
  595.         }
  596.  
  597. $1 ~ /[Aa]lias|[Gg]roup/ {
  598.  
  599.         if ( NF == 3)
  600.           print $2 " : user alias : " $3;
  601.         else {
  602.           group = ""
  603.           for (i = 3; i <= NF; i++) {
  604.             if (i == NF && $i == "\\") sep = ""
  605.             else        sep = ", "
  606.  
  607.             if ($i == "\\") {
  608.               group = sprintf("%s,", group)
  609.               next_line = 1;
  610.             }
  611.             else if (length(group) > 0)
  612.  
  613.  
  614.  
  615. Page 9
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.               group = sprintf("%s%s%s", group, sep, $i);
  628.             else
  629.               group = $i;
  630.             }
  631.             print $2 " : group alias : " group;
  632.           }
  633.         }
  634.  
  635. -------------------------------------------------------------------
  636.  
  637.      Note: this script is contained in the release under the
  638. name "mailrc.awk" in the utilities directory "utils".
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681. Page 10
  682.  
  683.  
  684.  
  685.  
  686. SHAR_EOF
  687. if test 13394 -ne "`wc -c < 'Alias.fmtd'`"
  688. then
  689.     echo shar: error transmitting "'Alias.fmtd'" '(should have been 13394 characters)'
  690. fi
  691. fi
  692. echo shar: extracting "'Config.fmtd'" '(11466 characters)'
  693. if test -f 'Config.fmtd'
  694. then
  695.     echo shar: will not over-write existing file "'Config.fmtd'"
  696. else
  697. cat << \SHAR_EOF > 'Config.fmtd'
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.                     Configuration Guide
  706.                            to the
  707.                       MSG Mail System
  708.  
  709.                    (C) Copyright 1986, by
  710.                         Dave Taylor
  711.  
  712.                      February 28, 1986
  713.  
  714.  
  715.      This document is intended as a supplement  to  the  Msg
  716. Users  Guide  and  is  only  of interest to sites having the
  717. source code to the msg system.
  718.  
  719.  
  720.      Virtually all of the installation dependent definitions
  721. are  contained  in  the  file  'hdrs/sysdefs.h', as detailed
  722. below;
  723.  
  724.  
  725. -------------------------------------------------------------
  726. #define USE_EMBEDDED_ADDRESSES
  727.  
  728. #define FIND_DELTA      10      /* for binary searches in path database  */
  729.  
  730. #define MAX_HEADERS     500     /* max number of messages in one file!   */
  731. #define MAX_SALIASES    503     /* number of system aliases allowed      */
  732. #define MAX_UALIASES    251     /* number of user aliases allowed        */
  733. #define MAX_IN_WEEDLIST 50      /* max headers to weed out               */
  734.  
  735. #define MAX_HOPS        35      /* max hops in return addr to E)veryone  */
  736.  
  737. #define MAX_ATTEMPTS    6       /* #times to attempt lock file creation */
  738.  
  739. #define REMOVE_AT_LAST          /* see leavembox.c */
  740.  
  741. #define DEFAULT_BATCH_SUBJECT   "no subject (file transmission)"
  742.  
  743. #define NOCHECK_VALIDNAME       /* see validname.c */
  744.  
  745. #define NOTES_HEADER            "/***** "
  746. #define NOTES_FOOTER            "/* ---------- */"
  747.  
  748. #ifdef BSD
  749. # define system_hash_file       "/usr/spool/mail/.alias_hash"
  750. # define system_data_file       "/usr/spool/mail/.alias_data"
  751. #else
  752. # define system_hash_file       "/usr/mail/.alias_hash"
  753. # define system_data_file       "/usr/mail/.alias_data"
  754. #endif
  755.  
  756.  
  757.  
  758.  
  759. Page 1
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771. #define pathfile                "/usr/lib/nmail.paths"
  772.  
  773. #define Lsys                    "/usr/lib/uucp/L.sys"
  774.  
  775. #define DEBUG           "Msg.debug.info"
  776.  
  777. #define temp_file       "/tmp/snd."
  778. #define temp_mbox       "/tmp/mbox."
  779. #define temp_print      "/tmp/print."
  780. #define mailtime_file   ".last_read_mail"
  781. #ifdef BSD
  782. #  define default_editor        "/usr/ucb/vi"
  783. #  define mailhome              "/usr/spool/mail/"
  784. #else
  785. #  define default_editor        "/usr/bin/vi"
  786. #  define mailhome              "/usr/mail/"
  787. #endif
  788.  
  789. #define sendmail        "/usr/lib/sendmail"
  790. #define sendmailflags   "-oi"
  791. #define mailer          "/bin/rmail"
  792. #define mailx           "/usr/bin/mailx"
  793.  
  794. #define helphome        "/usr/local/lib/"
  795. #define helpfile        "main.help"
  796.  
  797. #define msgrcfile       "/.msgrc"
  798. #define mailheaders     ".msgheaders"
  799. #define unedited_mail   "emergency.mbox"
  800. #define newalias        "newalias 1>&2 > /dev/null"
  801.  
  802. #define remove          "/bin/rm -f"            /* how to remove a file */
  803. #define cat             "/bin/cat"              /* how to display files */
  804.  
  805. -------------------------------------------------------------
  806.  
  807.  
  808.  
  809. USE_EMBEDDED_ADDRESSES This controls the mailers response to
  810.                messages  that contain "Reply-To:" or "From:"
  811.                lines that actually contain a return address.
  812.                If  it's  defined, the mailer will attempt to
  813.                use the  address  specified  (overriding  the
  814.                return  address  built from the path that the
  815.                mail took).  It will look the address  up  in
  816.                the pathalias database (see the documentation
  817.                on the alias system)  for  incomplete  paths,
  818.                but it is still recommended that this be left
  819.                undefined.
  820.  
  821.  
  822.  
  823.  
  824.  
  825. Page 2
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.                     This will, of course,  make  the  mailer
  838.                not be a standard 'RFC-822' mailer, since the
  839.                mail system is defined to use the reply-to if
  840.                included rather than the return address, but,
  841.                at least for addresses on the  ARPA  net,  it
  842.                ain't going to work a lot of the time!
  843.  
  844. FIND_DELTA     This is the delta that the binary  search  of
  845.                the  pathalias database will use to determine
  846.                when it's slicing up a  single  line,  rather
  847.                than  a  multitude  of lines.   Ideally, this
  848.                should be set to 1 byte less than  the  shor-
  849.                test  line  in  the  file...the default is 10
  850.                bytes.
  851.  
  852. MAX_HEADERS      The maximum number of messages allowed in a
  853.                single mailbox.
  854.  
  855. MAX_SALIASES     The number of system aliases allowed.   (It
  856.                is recommended that this be a prime number to
  857.                improve the performance of the hashing  func-
  858.                tion (it's a complicated proof!))
  859.  
  860. MAX_UALIASES   The number of user aliases allowed.   (should
  861.                be a prime number - see the comment above)
  862.  
  863. MAX_IN_WEEDLIST The maximum number of headers  that  can  be
  864.                specified  in  the weedout list of the .msgrc
  865.                file.  A suggested  alternative  approach  if
  866.                this  number  is too small is to specify ini-
  867.                tial  substrings  in  the  file  rather  than
  868.                increasing  the number.  For example, say you
  869.                want to weedout the headers  "Latitude:"  and
  870.                "Latitudinal-Coords:",   you   could   simply
  871.                specify  "Latitud"  and  match   them   both!
  872.                Furthermore  you  could  also specify headers
  873.                like "X-" and remove  all  the  user  defined
  874.                headers!
  875.  
  876. MAX_HOPS       When replying to a G)roup, this is  the  max-
  877.                imum  number  of hops that a message can have
  878.                taken.  This is used to try to  optimize  the
  879.                return  address  (remove  cyclic loops and so
  880.                on) and regular  use  should  show  that  the
  881.                default of 35 is plenty more than you'll ever
  882.                need!
  883.  
  884. MAX_ATTEMPTS   When   reading   in   the   default   mailbox
  885.                (/usr/mail/$username)  the  mailer  creates a
  886.                file  called  "/usr/mail/$username.lock"   to
  887.                ensure  that  no  mail  is  added to the file
  888.  
  889.  
  890.  
  891. Page 3
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.                while it's being either read, or replaced (ie
  904.                written  to).   Occasionally,  this lock file
  905.                will already be in  place  since  someone  is
  906.                currently  sending you mail.  If this occurs,
  907.                the mailer will wait a few seconds and try to
  908.                create  the  lock file again.  This parameter
  909.                defines the number of tries the mailer should
  910.                take before giving up.
  911.  
  912. REMOVE_AT_LAST When it does decide to give up  after  trying
  913.                to  create  the lock file, (see MAX_ATTEMPTS,
  914.                above) this will define how to act.  If  it's
  915.                defined,  the  mailer  will attempt to remove
  916.                the lock file after the MAX_ATTEMPTS timeout.
  917.                On  the  other hand, if it's not defined (the
  918.                recommended  state)  it'll  simply  quit  the
  919.                mailer,  telling  the  user to try again in a
  920.                few minutes.
  921.  
  922. DEFAULT_BATCH_SUBJECT What the subject should be on messages
  923.                that are from redirected input but don't have
  924.                a subject specified...
  925.  
  926. NOCHECK_VALIDNAME This disables the checking  of  validnames
  927.                on  the  existing  machine.  On machines that
  928.                run a system such as  sendmail  and  use  the
  929.                sendmail   alias   feature,  this  should  be
  930.                defined.  On other  systems  this  should  be
  931.                left  as  the  default (not defined) to avoid
  932.                users generating "dead.letter" files...
  933.  
  934. NOTES_HEADER   This defines the first  "word"  of  the  line
  935.                that a notes file entry would contain.
  936.  
  937. NOTES_FOOTER   This  defines  the  footer  line   (in   it's
  938.                entirety).
  939.  
  940. system_hash_file This is the file that contains  the  hashed
  941.                version  of  the  system aliases.  It is also
  942.                used in the newalias command.  (note that  it
  943.                is defined differently if you're running on a
  944.                Berkeley system)
  945.  
  946. system_data_file This is the other file the newalias command
  947.                installs  in  the  system  alias area.  (Note
  948.                this is defined differently if you're runnnig
  949.                a bsd system)
  950.  
  951. pathfile       This  defines  the  location  of  the   alias
  952.                datafile.   This  file  is in the format that
  953.                pathalias generates, that is;
  954.  
  955.  
  956.  
  957. Page 4
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.                    machine <tab> address
  971.  
  972.                For further information, please see  the  Msg
  973.                Alias System documentation.
  974.  
  975. Lsys           This defines where the system L.sys  file  is
  976.                kept.  This is used for the mailer to quickly
  977.                know what machines the  current  machine  can
  978.                talk  to  directly (to avoid trying to search
  979.                the pathalias database to route mail to these
  980.                machines).
  981.  
  982. DEBUG          The name of the file to put in the users home
  983.                directory  if  they  choose  to  use the "-d"
  984.                debug option.
  985.  
  986. temp_file      Temporary file for sending outbound messages.
  987.                Place  to  keep  copy  of incoming mailbox to
  988.                avoid collisions with newer mail.
  989.  
  990. temp_print     File to use when creating  a  printout  of  a
  991.                message.
  992.  
  993. mailtime_file  File to compare date to  to  determine  if  a
  994.                given  message is New since the last time the
  995.                mail was read or not.
  996.  
  997. default_editor If no editor is specified in the users .msgrc
  998.                file, this is which editor to use.  ENSURE IT
  999.                IS A VALID EDITOR  ON  THIS  MACHINE!!   (Not
  1000.                that  the  default home for "vi" is different
  1001.                on BSD machines)
  1002.  
  1003. mailhome       Where all the  incoming  mailboxes  are,  and
  1004.                also  where  the  'lock' files have to be put
  1005.                for the mailer to know not to  add  new  mail
  1006.                while  we're  reading/writing  the  mailfile.
  1007.                (note that mail is kept in a different direc-
  1008.                tory on Berkeley systems)
  1009.  
  1010. sendmail       Defines where sendmail is (if you have it  on
  1011.                your system).
  1012.  
  1013. sendmailflags  Defines the flags to hand to sendmail if  and
  1014.                when the program chooses to use it.
  1015.  
  1016. mailer         If you  don't  have  sendmail,  this  is  the
  1017.                mailer that'll be used.
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023. Page 5
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035. mailx          If all else fails, this mailer can be used in
  1036.                a rather dumb way.
  1037.  
  1038. helphome       Where the help file is kept (soon to be  help
  1039.                files!)
  1040.  
  1041. helpfile       The name of the main helpfile (kept in  "hel-
  1042.                phome").
  1043.  
  1044. msgrcfile      The  name  of  the  automatic  control   file
  1045.                (currently ".msgrc")
  1046.  
  1047. mailheaders      The name of the optional  file  that  users
  1048.                may have that will be included in the headers
  1049.                of each outbound message.
  1050.  
  1051. unedited_mail  In the strange case when the mailer  suddenly
  1052.                finds  all  the  directories it uses shut off
  1053.                (like /usr/mail and /tmp) then it'll put  the
  1054.                current  mailbox  into this file in the users
  1055.                home directory.
  1056.  
  1057. newalias       How to install new aliases..
  1058.  
  1059. remove         How to remove a file.
  1060.  
  1061. cat            How to display a file to stdout.
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089. Page 6
  1090.  
  1091.  
  1092.  
  1093.  
  1094. SHAR_EOF
  1095. if test 11466 -ne "`wc -c < 'Config.fmtd'`"
  1096. then
  1097.     echo shar: error transmitting "'Config.fmtd'" '(should have been 11466 characters)'
  1098. fi
  1099. fi
  1100. exit 0
  1101. #    End of shell archive
  1102.